<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 3//EN">
<HTML><HEAD>
		<TITLE>User's Reference - Sequencer</TITLE>
		<META HTTP-EQUIV="keywords" CONTENT="GRAPHICS VISUALIZATION VISUAL PROGRAM DATA
MINING">
	<meta http-equiv="content-type" content="text/html;charset=ISO-8859-1">
</HEAD><BODY BGCOLOR="#FFFFFF" link="#00004b" vlink="#4b004b">
		<TABLE width=510 border=0 cellpadding=0 cellspacing=0>
			<TR>
				<TD><IMG src="../images/spacer.gif" width=80 height=1></TD>
				<TD><IMG src="../images/spacer.gif" width=49 height=1></TD>
				<TD><IMG src="../images/spacer.gif" width=24 height=1></TD>
				<TD><IMG src="../images/spacer.gif" width=100 height=1></TD>
				<TD><IMG src="../images/spacer.gif" width=3 height=1></TD>
				<TD><IMG src="../images/spacer.gif" width=127 height=1></TD>
				<TD><IMG src="../images/spacer.gif" width=6 height=1></TD>
				<TD><IMG src="../images/spacer.gif" width=50 height=1></TD>
				<TD><IMG src="../images/spacer.gif" width=71 height=1></TD>
			</TR>
			<TR>
				<TD colspan=9><IMG src="../images/flcgh_01.gif" width=510 height=24 alt="OpenDX - Documentation"></TD>
			</TR>
			<TR>
				<TD colspan=2><A href="../allguide.htm"><IMG src="../images/flcgh_02.gif" width=129 height=25 border="0" alt="Full Contents"></A></TD>
				<TD colspan=3><A href="../qikguide.htm"><IMG src="../images/flcgh_03.gif" width=127 height=25 border="0" alt="QuickStart Guide"></A></TD>
				<TD><A href="../usrguide.htm"><IMG src="../images/flcgh_04.gif" width=127 height=25 border="0" alt="User's Guide"></A></TD>
				<TD colspan=3><B><A href="../refguide.htm"><IMG src="../images/flcgh_05d.gif" width=127 height=25 border="0" alt="User's Reference"></A></B></TD>
			</TR>
			<TR>
				<TD><A href="refgu133.htm"><IMG src="../images/flcgh_06.gif" width=80 height=17 border="0" alt="Previous Page"></A></TD>
				<TD colspan=2><A href="refgu135.htm"><IMG src="../images/flcgh_07.gif" width=73 height=17 border="0" alt="Next Page"></A></TD>
				<TD><A href="../refguide.htm"><IMG src="../images/flcgh_08.gif" width=100 height=17 border="0" alt="Table of Contents"></A></TD>
				<TD colspan=3><A href="refgu009.htm"><IMG src="../images/flcgh_09.gif" width=136 height=17 border="0" alt="Partial Table of Contents"></A></TD>
				<TD><A href="refgu175.htm"><IMG src="../images/flcgh_10.gif" width=50 height=17 border="0" alt="Index"></A></TD>
				<TD><A href="../srchindx.htm"><IMG src="../images/flcgh_11.gif" width=71 height=17 border="0" alt="Search"></A></TD>
			</TR>
		</TABLE>
		<H3><A name="HDRSEQUENC" ></A>Sequencer</H3>
		<A NAME="IDX690"></A><A NAME="IDX691"></A>
<P><STRONG>Category</STRONG>
<P>
<A HREF="refgu008.htm#HDRCATSPE">Special</A>
<A NAME="IDX692"></A>
<P><STRONG>Function</STRONG>
<P>
Generates a sequence of integers.
<P>
<P><STRONG>Syntax</STRONG>
<P>
The sequencer is available in script mode and in the user interface.
However, it can be data driven only in the user interface
(see <A HREF="usrgu050.htm#HDRUSL">Chapter 10. "Data Explorer Scripting
Language"</A> in <I>IBM Visualization Data Explorer User&#39;s Guide</I>,
and the example later in this section.)
<P><STRONG>Inputs</STRONG>
<BR>
<TABLE BORDER>
<TR>
<TH ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">Name
</TH><TH ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">Type
</TH><TH ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">Default
</TH><TH ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">Description
</TH></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%"><TT><STRONG>min</STRONG></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">integer
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">1
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">minimum of integer sequence
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%"><TT><STRONG>max</STRONG></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">integer
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">100
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">maximum of integer sequence
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%"><TT><STRONG>delta</STRONG></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">integer
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">1
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">numerical interval between
successive integers in the sequence
</TD></TR></TABLE>
<P><STRONG>Outputs</STRONG>
<BR>
<TABLE BORDER>
<TR>
<TH ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">Name
</TH><TH ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">Type
</TH><TH ALIGN="LEFT" VALIGN="TOP" WIDTH="50%">Description
</TH></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%"><TT><STRONG>frame</STRONG></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">integer
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="50%">frame number
</TD></TR></TABLE>
<P><STRONG>Functional Details</STRONG>
<P>
This module allows a user to "animate" a visualization.
Through inputs to the module (outputs from other tools or values set
in its configuration dialog box) the interactor can be
"data driven."
<P>
If the interactor is not data-driven, its attributes
are taken from its <TT><STRONG>Frame Control</STRONG></TT> dialog box
(accessed from the <TT><STRONG>...</STRONG></TT> button).
<P>

The configuration dialog box for Sequencer can be accessed by selecting
the Sequencer icon in the VPE and then choosing
<TT><STRONG>Configuration</STRONG></TT> in the <TT><STRONG>Edit</STRONG></TT>
menu.

<TABLE CELLPADDING="3">
<TR VALIGN="TOP"><TD><P><B><TT><STRONG>min</STRONG></TT> &nbsp;and&nbsp;
<TT><STRONG>max</STRONG></TT>
</B></TD><TD><P>specify the minimum and maximum integer values (frame
numbers) for an "animation" sequence.
By default, <TT><STRONG>min</STRONG></TT> = 1 and <TT><STRONG>max</STRONG></TT>
= 100.
</TD></TR><TR VALIGN="TOP"><TD><P><B><TT><STRONG>delta</STRONG></TT>
</B></TD><TD><P>specifies the increment between integers in the output sequence.
If <TT><STRONG>min</STRONG></TT> and <TT><STRONG>max</STRONG></TT> are equal,
<TT><STRONG>delta</STRONG></TT> is ignored.
By default, <TT><STRONG>delta</STRONG></TT> = 1.
</TD></TR></TABLE>
<P><B>Note: </B>If <TT><STRONG>min</STRONG></TT> is specified, and either
<TT><STRONG>min</STRONG></TT> or <TT><STRONG>max</STRONG></TT>
change, the output value (<TT><STRONG>frame</STRONG></TT>)
is set to the new <TT><STRONG>min</STRONG></TT> value
and the Start and Stop values in the Frame
Control dialog box are set to the new
minimum and maximum, respectively.
<P>
However, if <TT><STRONG>min</STRONG></TT> is not specified and
<TT><STRONG>max</STRONG></TT> is and then changes on the next
execution, the output frame value becomes the current
Start value as set in the Frame Control dialog box.
<P><STRONG>Script Language Example</STRONG>
<P>
The following example uses the Sequencer in script mode to display a
series of isosurfaces.
The input to the macro <TT>do&#95;each&#95;frame</TT> is the frame
number, which is converted into an isosurface value by
multiplying it by 0.05.
The initialization values are set by <TT>@startframe, @endframe,
and @nextframe</TT>.
The sequence command invokes the macro for each step of
the sequence.
Finally, the play command starts the Sequencer running.
For more information about using the sequencer
in script mode,
see <A HREF="usrgu050.htm#HDRUSL">Chapter 10. "Data Explorer Scripting
Language"</A> in <I>IBM Visualization Data Explorer User&#39;s Guide</I>.
<P>
<PRE>
macro do&#95;each&#95;frame(frame)
&#123;
   isovalue = frame*.05;
   isosurface = Isosurface(data,isovalue);
   Display(isosurface,camera);
&#125;
data = Import("/usr/local/dx/samples/data/cloudwater");
camera = AutoCamera(data);
@startframe = 1;
@endframe = 5;
@nextframe = @startframe;
sequence do&#95;each&#95;frame(@frame);
play;
</PRE>
<P><STRONG>Example Visual Programs</STRONG>
<P>
Many of the example visual programs use a sequencer,
including&#58;
<PRE>
ContoursAndCaption.net
GeneralImport1.net
MovingCamera.net
</PRE>
<P>
The following example visual program uses a data-driven Sequencer:
<PRE>
Imide&#95;potential.net
</PRE>
		<P>
		<HR>
		<DIV align="center">
			<P><A href="../allguide.htm"><IMG src="../images/foot-fc.gif" width="94" height="18" border="0" alt="Full Contents"></A> <A href="../qikguide.htm"><IMG src="../images/foot-qs.gif" width="94" height="18" border="0" alt="QuickStart Guide"></A> <A href="../usrguide.htm"><IMG src="../images/foot-ug.gif" width="94" height="18" border="0" alt="User's Guide"></A> <A href="../refguide.htm"><IMG src="../images/foot-ur.gif" width="94" height="18" border="0" alt="User's Reference"></A></P>
		</DIV>
		<DIV align="center">
			<P><FONT size="-1">[ <A href="http://www.research.ibm.com/dx">OpenDX Home at IBM</A>&nbsp;|&nbsp;<A href="http://www.opendx.org/">OpenDX.org</A>&nbsp;] </FONT></P>
			<P></P>
		</DIV>
		<P></P>
	</BODY></HTML>
